home *** CD-ROM | disk | FTP | other *** search
/ PCX Clip Art - Professional Plus / PCX Clip Art - Professional Plus.iso / tools / amiga / dms111.txt < prev    next >
Text File  |  1993-12-23  |  15KB  |  460 lines
  1. FILE: DMS.doc - AmigaDOS version 1.11 documentation  - 7/1/91
  2.  
  3. *****************************************************************************
  4.  
  5.                           The DISK-Masher
  6.                    Copyright (c) 1989-1991 SDS Software
  7.  
  8.  
  9. *****************************************************************************
  10.  
  11.  
  12. What is it?
  13.  
  14.     The DISK-Masher (DMS) is a utility that allows users to compress and
  15. archive floppy disks.  Version 1.11 requires at least 512k of memory, and
  16. AmigaDOS version 1.2 or later.
  17.  
  18. Why a disk archiver?
  19.  
  20.     Many programs are available for archiving individual files and do a
  21. relatively good job.  However DMS was created for the purpose of archiving
  22. whole disks.  It is useful for archiving non-filing system disks which cannot
  23. be done with standard file archivers, sending distribution disks, archiving
  24. library collections, and many other uses.  DMS takes much less time to
  25. put a disk back together than with a file archiver and is less wear and
  26. tear on your disk drives.
  27.  
  28. Why not use other disk archivers?
  29.  
  30.     DMS has been tested against every other similar type programs and will
  31. provide faster execution, greater compression, more support features, and
  32. continuing user support.  Once you try DMS you won't be satisfied with
  33. anything else.  Among other things DMS provides:
  34.  
  35.     - Highly optimized compression routines offerring the utmost
  36.       in speed and compression.  4 different routines to choose from
  37.       to satisfy your needs.
  38.  
  39.     - The ability to read and write to or from any AmigaDOS device conforming
  40.       to the standard 80 tracks , 512 bytes per block , 11 blocks per track,
  41.       2 sides, Ex: DF0:, DF1:, RAD:, etc.
  42.  
  43.     - Extended Virus checking of the boot blocks.  Other disk archivers
  44.       just show the boot block and do not check for viruses, this is
  45.       extremely stupid, most viruses do not come out and say "Look here,
  46.       I'm a virus!".  Without actually checking the boot block you're
  47.       opening up a can of worms.  Therefore DMS currently checks for over
  48.       60 different viruses and custom boot blocks and can automatically
  49.       install the disk.  It is still Important that users monitor their
  50.       system periodically with a virus checker as there are many types
  51.       of viruses. 
  52.  
  53.     - Data Security.  DMS has the option to encrypt archives with a user
  54.       selected password for security.
  55.  
  56.  
  57. *****************************************************************************
  58.  
  59.                     Command Line Options and Usage
  60.  
  61.   The general format for a DMS command is:
  62.  
  63.   DMS command file[.DMS] [OPTIONS ...]
  64.  
  65.   Everything in braces [] is optional. Everything else is required.
  66.  
  67.   file[.DMS] is a user specified filename.  The .DMS ending will
  68.   automatically be appended to the filename if you do not include it.
  69.   This is done to avoid confusion with other archiver formats.
  70.  
  71.  
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73.  
  74. 1.) READ
  75.  
  76.   This command will read and compress a disk.  The basic usage for this
  77.   command is:
  78.  
  79.   DMS Read file[.DMS] [FROM Dev:] [TEXT filetext] [CMODE mode] [LOW lowtrack]
  80.                       [HIGH hightrack] [NOVAL] [NOZERO] [ENCRYPT password]
  81.  
  82.   file[.DMS]
  83.  
  84.   - the output file which will contain the archived disk.
  85.  
  86. OPTIONS:
  87.  
  88.   FROM Dev:
  89.  
  90.   - Will read the disk from a different device.  The default device is DF0:
  91.     (internal drive).  You may choose any device as long as it has 80 tracks,
  92.     2 sides, 11 sectors/track, and 512 bytes per sector.
  93.     Examples: DF0:, DF1:, DF2:, DF3:, RAD:, FM0:, FF0:, etc.
  94.  
  95.   TEXT filetext
  96.  
  97.   - Causes DMS to read in the file 'filetext' and add it to the archive.
  98.     When the archive is extracted the text will be displayed before writing
  99.     the disk.  This is useful for identifying disks or giving other
  100.     information about the archive.  
  101.  
  102.   CMODE mode
  103.  
  104.   - Chooses the compression mode used.  Mode is either NONE, HEAVY1, HEAVY2,
  105.     or BEST
  106.  
  107.     The default mode is BEST
  108.  
  109.     Available modes are:
  110.  
  111.       NONE   - No Compression is performed (Straight Read).
  112.       HEAVY1 - Heavy compression, good speed/compression ratio.
  113.       HEAVY2 - Best available compression.  Only available with >1meg ram.
  114.       BEST   - Chooses Best compression method for available memory.
  115.  
  116.   LOW lowtrack
  117.  
  118.   - Specifies the starting track to read from.  The default is track 0.
  119.     Lowtrack must be a value from 0 to 79.
  120.  
  121.   HIGH hightrack
  122.  
  123.   - Specifies the ending track to stop at.  The default is track 79.
  124.     Hightrack must be a value from 0 to 79.
  125.  
  126.   NOVAL
  127.  
  128.   - Stops DMS from inhibiting the disk validator when reading the disk.
  129.  
  130.   NOZERO
  131.  
  132.   - Normally DMS will read the AmigaDOS bitmap from the disk and archive
  133.     only sectors which are being used.  If the disk is a non-filing system
  134.     disk or has a bad bitmap, DMS will automatically archive the whole disk.
  135.     In EXTREME cases DMS will make a wrong assumption about the type of
  136.     disk it is archiving. NOZERO will cause DMS to archive the whole disk
  137.     totally ignoring the disk bitmap.  Generally you will rarely if ever
  138.     have to use this option.
  139.  
  140.   ENCRPYT password
  141.  
  142.   - Causes DMS to encrypt the input from the disk using the password
  143.     supplied. 'password' is any alphanumeric word you desire.
  144.     Examples: Joe, Fred, ABC1234, ONLY-FOR-ME, etc.
  145.  
  146. EXAMPLES:
  147.  
  148.   DMS read disk1
  149.  
  150.   - Will compress a disk from drive DF0: using the default compression mode
  151.     and store the results in the file 'disk1.DMS'
  152.  
  153.   DMS read stuff.DMS lowtrack 20
  154.  
  155.   - Will compress only tracks 20 to 79 into file 'stuff.DMS'
  156.  
  157.   DMS read stuff lowtrack 40 hightrack 40
  158.  
  159.   - Will compress only track 40 into file 'stuff.DMS'
  160.  
  161.   DMS read stuff from df1: cmode heavy1 noval nozero text RAM:intro
  162.  
  163.   - Will compress a disk from drive DF1: using compression mode HEAVY1, not
  164.     inhibiting the disk validator, not using the disk bitmap and adding
  165.     the text from file 'RAM:intro' to the file 'stuff.DMS'
  166.  
  167.   DMS read stuff.DMS from RAD: encrypt JOESTUFF1
  168.  
  169.   - Will compress a disk from ram drive RAD: and encrypting the output
  170.     with the password 'JOESTUFF1' to file 'stuff.DMS'
  171.  
  172.   DMS read stuff.DMS text CON:0/0/640/200/window
  173.  
  174.   - Will compress a disk and allow you to quickly add text to the archive.
  175.     A console window will open up and you can then type any text you
  176.     want.  To finish type CTRL \ to close the window and continue.
  177.  
  178.  
  179. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  180.  
  181. 2.) WRITE
  182.  
  183.   This command will uncompress and write a disk.  The basic usage for this
  184.   command is:
  185.  
  186.   DMS Write file[.DMS],,, [TO Dev:] [LOW lowtrack] [HIGH hightrack]
  187.                           [NOVAL] [NOTEXT] [NOPAUSE] [DECRYPT password]
  188.  
  189.   file[.DMS],,,
  190.  
  191.   - One or more input files to be extracted.  Standard AmigaDOS wildcards
  192.     are supported.
  193.  
  194. OPTIONS:
  195.  
  196.   TO Dev:
  197.  
  198.   - Will write the output to device Dev: (the default is drive DF0:)
  199.     The device must follows the same rules as in the READ command.
  200.  
  201.   LOW lowtrack
  202.  
  203.   - Specifies the starting track to write from.  Tracks before lowtrack
  204.     will be ignored.  Default is track 0
  205.  
  206.   HIGH hightrack
  207.  
  208.   - Specifies the ending track to write from.  Tracks after hightrack
  209.     will be ignored.  Default is track 79
  210.  
  211.   NOVAL
  212.  
  213.   - Stops DMS from inhibiting the disk validator when writing a disk.
  214.  
  215.   NOTEXT
  216.  
  217.   - Causes DMS to ignore any text to be displayed from the archive.
  218.  
  219.   NOPAUSE
  220.  
  221.   - Stops DMS from pausing after displaying any text from the archive.
  222.  
  223.   DECRPYT password
  224.  
  225.   - Causes DMS to decrypt the archive with the password 'password'.
  226.     This is only used if the archive was previously encrypted.  'password'
  227.     must be the EXACT same one used when encrypting the file otherwise
  228.     the archive will not be processed correctly.
  229.  
  230. EXAMPLES:
  231.  
  232.   DMS write stuff
  233.  
  234.   - Will extract the archive stuff.DMS to drive DF0:
  235.  
  236.   DMS write part1 part2.dms TO DF2: NOTEXT
  237.  
  238.   - Will extract the archives part1.DMS and part2.DMS to drive DF2: ,
  239.     ignoring any banner text in the archives
  240.  
  241.  
  242. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  243.  
  244. 3.) REPACK
  245.  
  246.   This command allows you to recompress an older DMS archive.  It can also
  247.   be used as a simple split utility.  T